Welcome to With Class 2.1 Educational Version (10 Class Limit) 1. Installing With Class The following are the minimum system requirements for With Class: - 80386 processor or higher (80486 or higher recommended) - MS-Windows 3.1 or higher - Mouse that supports MS-Windows - VGA monitor - 1024x768 or higher resolution recommended To initially install and run With Class, follow these steps: >> Copy all With Class files into a directory, e.g. wc2 >> Copy MFCOLEUI.DLL into C:\WINDOWS\SYSTEM >> Copy DATADIC1.DOT to the WINWORD\TEMPLATE directory if Microsoft Word 6.0 is present >> Ensure CTL3D.DLL in your path, e.g. C:\WINDOWS\SYSTEM is in your autoexec.bat path statement >> Ensure the following files are in the C:\WINDOWS\SYSTEM directory: COMPOBJ.DLL, STORAGE.DLL, OLE2.DLL, OLE2DISP.DLL, OLE2NLS.DLL, CTL3D.DLL, AND MFCOLEUI.DLL. If not installed, copy the provided dll's into C:\WINDOWS\SYSTEM. Note - do not overwrite any installed dll's unless you have a problem. A early wc2 release contained OLE2 dll's dated 11/16/94 which caused some problems with Microsoft Office applications. Specifically, you could not run Microsoft Chart from Microsoft Word 6.0. This release contains the OLE2 dll's dated 11/20/94 which work well with Microsoft Office applications. >> Ensure SHARE is either executed automatically or is in your autoexec.bat. Sample entries are C:\DOS\SHARE, C:\DOS\SHARE /L:500, OR C:\DOS\SHARE /F:5100 /L:500. Alternatively, a sample config.sys entry is INSTALL=SHARE /F:4096. >> In Windows Program Manager, create the With Class icon by selecting "File New", "Program Icon", and entering WC2.EXE >> In Windows, run With Class from Windows, e.g. "File Run WC2.EXE" or double click the With Class icon To install With Class from a disk provided from MicroGold: Type from windows program manager FILE | RUN a:install.exe. To print user instructions, print topics from the Help Menu. With Class file creates wc2.ini in the windows directory. If you have problems launching With Class, delete WC2.INI so that it is automatically regenerated. If you have video problems, try using standard VGA (640 x 480) or the most up-to-date video drivers available for your video card. Ensure you are using the dll's provided with the product. Older version dll's may be on your system in another directory and may be invoked. If you have any installation problems, contact MicroGold Software at 71543.1172@compuserve.com. Known Limitations with this educational version : (1) Due to OLE constraints only 3 diagrams may be open at a time. When you try to save the 4th diagram, you may get an error, e.g. Illegal File Name. If you get this error, close one or more diagrams and save the diagram. (2) Once an OLE object is inserted into a diagram using Insert Object, it cannot be deleted. (3) OLE Copy is experimental and may cause unpredictable results if you use Copy OLE menu command to copy, paste, and activate a diagram into MS Word 6.0. To copy a diagram into another Windows application, it is recommended that you use Copy for a bitmap copy. (4) Cut is not implemented. (5) Put only 10 classes on a diagram. Putting 11 or more classes on the educational version may cause unpredicable results. 2. Primary Files in this release - readme.txt Installation Instructions - wc2.exe With Class Program - wc2.hlp With Class Help Program - *.dll DLL's used by With Class Program - wc2tutor.wri O-O Modeling Using With Class - codegen.wri Instructions on Generating Code Using Scripts - *.sct Text Script Files for custom reports and code generation - *.omt Class diagrams to test code generation scripts - datadic1.dot Microsoft Word 6.0 document template for a data dictionary 3. Using With Class Scripts >> Launch With Class from Windows >> Open a class diagram, e.g. cppcar.omt >> Select "Generate - Generate Report" >> Enter a report name, e.g. REPORT.TXT >> Select RPTALL.SCT to generate the report >> Select "File - Edit File" and open REPORT.TXT Here is a list of all the script variables that may be used to create custom reports and code generation. CLASS_NAME or CLASS CLASS_CARDINALITY CLASS_CONCURRENCY CLASS_PERSISTENCE CLASS_ACCESS CLASS_FILENAME CLASS_AUTHOR_INITIALS CLASS_LIBRARY_BASE_CLASS CLASS_INVARIANT CLASS_DESCRIPTION INCLUDE_FILE ATTRIBUTE_NAME ATTRIBUTE_TYPE ATTRIBUTE_ACCESS ATTRIBUTE_MAX_VALUE ATTRIBUTE_MIN_VALUE ATTRIBUTE_CONSTRAINT ATTRIBUTE_INITIAL_VALUE ATTRIBUTE_INFO OPERATION_NAME OPERATION_RETURN_TYPE CPP_OPERATION_PARAMETERS OPERATION_ACCESS OPERATION_TRANSFORMATION OPERATION_PRECONDITION OPERATION_POSTCONDITION OPERATION_EXCEPTION_TYPE OPERATION_EXCEPTION_NAME OPERATION_CLASSIFICATION OPERATION_CONCURRENCY OPERATION_CODE OPERATION_COMMENT1 OPERATION_COMMENT2 OPERATION_COMMENT3 ASSOCIATION_CLASS ASSOCIATION_NAME AGGREGATION_CLASS AGGREGATION_NAME ASSOCIATION_ONE_CLASS ASSOCIATION_ONE_NAME AGGREGATION_ONE_CLASS AGGREGATION_ONE_NAME ASSOCIATION_MANY_CLASS ASSOCIATION_MANY_NAME AGGREGATION_MANY_CLASS AGGREGATION_MANY_NAME BASE_CLASS CPP_OPERATIONS CPP_OPERATION_VIRTUAL CPP_OPERATION_PURE_VIRTUAL CPP_OPERATION_CONSTANT CPP_OPERATION_STATIC CPP_ATTRIBUTES CPP_BASE_CLASSES CPP_AGGREGATIONS CPP_ASSOCIATIONS PASCAL_OPERATION_PARAMETERS PASCAL_OPERATION_PARAMETERS_PAREN PASCAL_OPERATION_PARAMETERS_WITH_VAR PASCAL_OPERATION_RETURN_TYPE PASCAL_OPERATION_VIRTUAL ADA_OPERATION_PARAMETERS SMALLTALK_OPERATION_PARAMETERS ACTOR_OPERATION_PARAMETERS CLASS_PERSISTENT - prints persistent LITERAL_SYMBOL NO_RETURN NO_REPEAT DELETE_LAST_SYMBOL TRUNCATE_EIGHT [ ] // anything placed in between these will be repeated for every // attribute, operation, constant, etc. $ // use this to separate out keywords (above) from text that you wish to run in juxtaposition. 4. Creating a Data Dictionary in Microsoft Word 6.0 You can create a text data dictionary by running the script rptdict.sct. However, it is recommended that you create your data dictionary in Microsoft Word 6.0 to be able to sort and set fonts. To create a data dictionary in Microsoft Word 6.0 follow these steps: >> Copy the Microsoft Word 6.0 template datadic1.dot into the Winword\template directory >> Launch With Class from Windows >> Open a class diagram, e.g. cppcar.omt >> Select "Generate - Generate Report" >> Enter a report name, e.g. datadict.txt >> Select worddic1.sct to generate the text version of the data dictionary >> Launch Microsoft Word 6.0 >> Select "File - New" and Template datadic1 (datadic1.dot) >> Select "Insert - Database" >> Place cursor below the headings >> Select "Get Data" and Text Files (*.txt) and datadict.txt (generated data dictionary text file) >> Select "Insert Data" and All to import the data dictionary entries. >> Delete blank rows, set font sizes, sort as desired. 5. This version supports entering and saving data types from various languages. Data types are saved in the wc2.ini file. WC2.ini is created upon installation and if no wc2.ini exists. The initial wc2.ini has C/C++ data types, e.g. int, float. Whenever you enter a new data type for an attribute, the wc2.ini file is updated. When you begin using With Class, it is recommended that you create a diagram to enter the all the basic data types for attributes for the language and class library that you are using. The following are sample data types that may be used in various languages: - Microsoft Visual C++: CString needs #includes "stdafx.h" or - Borland C++ 3.X: String needs #include - Borland C++ 4.X: string needs #include - Pascal and Delphi: Byte, Integer, LongInt, Word, Real, char, String, Double - Ada: Boolean, Character, Integer, Float, Positive, Natural, Duration, String - Eiffel: BOOLEAN, CHARACTER, INTEGER, REAL, DOUBLE, ARRAY, STRING You may directly update the wc2.ini file to change a spelling or capitalization. If you modify the wc2.ini file ensure that Number = the number of types. Close With Class prior to making changes to wc2.ini If your wc2.ini file becomes corrupted, delete or rename wc2.ini and a new wc2.ini will be regenerated the next time you start With Class. 6.To receive e-mail newsletters and announcements, please send your e-mail address to Michael Gold, MicroGold Software at Internet 71543.1172@compuserve.com or CompuServe 71543,1172. We will periodically send out newsletters, announcements, and new scripts. Also, please send in the e-mail address of anyone who is interested in object-oriented CASE tools. Also, for technical questions please e-mail questions to the above address. Periodically, MicroGold uploads demo and shareware tools to the Internet. Currently the educational shareware version (10 class limit) of With Class 2.0 is at the following FTP sites: oak.oakland.edu/SimTel/win3/pgmtools/wclass21.zip and cica.indiana.edu. On CompuServe wclass.zip is in MSMFC/DOC/VIEW/UI, CASE/CASE, and WINSHARE/PROGRAMMING. On CompuServe type GO IBMFF and enter wclass.zip to find the latest version of the shareware With Class. The demo version of StateMaker (no save) is at the following FTP site: oak.oakland.edu/SimTel/win3/pgmtools/state31.zip. 7. Training and Consulting Services using With Class RCF Associates offers custom training and consulting services using With Class with object-oriented design projects with object- oriented languages. The following services and products are offered. - Custom model development (drawings and specifications) for a system based upon your requirements statement and block diagram. - Executable prototype for a system in C++, Eiffel, Ada, and other languages based upon your model (diagrams and specifications). - Custom With Class scripts for reports and code generation for your specific language, class library, and coding standards. - On-site training course "Object-Oriented Modeling with CASE and C++". Course is one to five days customized to your requirements including modeling your system during the course. - "Object-Oriented Modeling with CASE and C++" training manual (200 pages) and training course viewgraph masters (400 pages) both with 4 complete "charter to C++" case studies. - VHS Training Videos on Object-Oriented Modeling and Using With Class and StateMaker. Customer satisfaction is guaranteed. For information contact Richard Felsinger, RCF Associates, 960 Scottland Dr, Mt Pleasant, SC 29464 803-881-3648 e-mail 71162.755@compuserve.com 8. All users are encouraged to register this shareware for $59.00 at 1-908-722-6438 after 30 days. Users may order the With Class Professional Version with unlimited number of classes and laser printed user documentation for $149.00 plus $10.00 shipping and handling ($20.00 shipping and handling for orders outside the US.) Each With Class Profession comes with the StateMaker CASE tool for creating state transition diagrams and generating C/C++ code from the diagrams. StateMaker without With Class Professional is $99.00 plus $5.00 shipping and handling. Thank you for trying With Class. Michael Gold, MicroGold Software, 696 Birch Hill Drive, Bridgewater, NJ 08807 Telephone 1-908-722-6438 e-mail 71543,1172@compuserve.com